From bddf455874fcc648b8a743fe7616b5f8690108c0 Mon Sep 17 00:00:00 2001
From: =?utf8?q?Javier=20Jard=C3=B3n?= <jjardon@gnome.org>
Date: Sun, 16 May 2010 00:20:20 +0200
Subject: [PATCH] Move documentation to inline comments: GtkRecentAction

---
 docs/reference/gtk/tmpl/.gitignore           |  1 +
 docs/reference/gtk/tmpl/gtkrecentaction.sgml | 84 --------------------
 gtk/gtkrecentaction.c                        | 17 ++++
 3 files changed, 18 insertions(+), 84 deletions(-)
 delete mode 100644 docs/reference/gtk/tmpl/gtkrecentaction.sgml

diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore
index d8fbb174c6..c30497604f 100644
--- a/docs/reference/gtk/tmpl/.gitignore
+++ b/docs/reference/gtk/tmpl/.gitignore
@@ -6,6 +6,7 @@ gtkmessagedialog.sgml
 gtkobject.sgml
 gtkorientable.sgml
 gtkpagesetupunixdialog.sgml
+gtkrecentaction.sgml
 gtkseparator.sgml
 gtktesting.sgml
 gtktextiter.sgml
diff --git a/docs/reference/gtk/tmpl/gtkrecentaction.sgml b/docs/reference/gtk/tmpl/gtkrecentaction.sgml
deleted file mode 100644
index d47ea4c88e..0000000000
--- a/docs/reference/gtk/tmpl/gtkrecentaction.sgml
+++ /dev/null
@@ -1,84 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GtkRecentAction
-
-<!-- ##### SECTION Short_Description ##### -->
-An action of which represents a list of recently used files
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-A GtkRecentAction represents a list of recently used files, which
-can be shown by widgets such as #GtkRecentChooserDialog or 
-#GtkRecentChooserMenu.
-</para>
-<para>
-To construct a submenu showing recently used files, use a GtkRecentAction 
-as the action for a &lt;menuitem&gt;. To construct a menu toolbutton showing 
-the recently used files in the popup menu, use a GtkRecentAction as the 
-action for a &lt;toolitem&gt; element.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### SECTION Image ##### -->
-
-
-<!-- ##### STRUCT GtkRecentAction ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### ARG GtkRecentAction:show-numbers ##### -->
-<para>
-
-</para>
-
-<!-- ##### FUNCTION gtk_recent_action_new ##### -->
-<para>
-
-</para>
-
-@name: 
-@label: 
-@tooltip: 
-@stock_id: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_recent_action_new_for_manager ##### -->
-<para>
-
-</para>
-
-@name: 
-@label: 
-@tooltip: 
-@stock_id: 
-@manager: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_recent_action_get_show_numbers ##### -->
-<para>
-
-</para>
-
-@action: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gtk_recent_action_set_show_numbers ##### -->
-<para>
-
-</para>
-
-@action: 
-@show_numbers: 
-
-
diff --git a/gtk/gtkrecentaction.c b/gtk/gtkrecentaction.c
index 14acfb426a..458d23f019 100644
--- a/gtk/gtkrecentaction.c
+++ b/gtk/gtkrecentaction.c
@@ -32,6 +32,23 @@
 #include "gtkprivate.h"
 #include "gtkalias.h"
 
+
+/**
+ * SECTION:gtkrecentaction
+ * @Short_description: An action of which represents a list of recently used files
+ * @Title: GtkRecentAction
+ *
+ * A #GtkRecentAction represents a list of recently used files, which
+ * can be shown by widgets such as #GtkRecentChooserDialog or
+ * #GtkRecentChooserMenu.
+ *
+ * To construct a submenu showing recently used files, use a #GtkRecentAction
+ * as the action for a &lt;menuitem&gt;. To construct a menu toolbutton showing
+ * the recently used files in the popup menu, use a #GtkRecentAction as the
+ * action for a &lt;toolitem&gt; element.
+ */
+
+
 #define FALLBACK_ITEM_LIMIT     10
 
 #define GTK_RECENT_ACTION_GET_PRIVATE(obj)      \
-- 
2.30.2